<HTML>
<HEAD><TITLE>HelpURL Help</TITLE>
<META HTTP-EQUIV="ISBN" CONTENT="helpurl.htm">
<META HTTP-EQUIV="SHORTTITLE" CONTENT="HelpURL Help">
<!-- some reasonable fonts for help books. otherwise, depends on current user settings -->
<META HTTP-EQUIV="PREF.H1"
	CONTENT="{font: {family: 'espy, face: 1, size: 10}, above: 'top}">
<META HTTP-EQUIV="PREF.P"
	CONTENT="{font: {family: 'espy, face: 0, size: 10}}">
<META HTTP-EQUIV="PREF.LI"
	CONTENT="{font: {family: 'espy, face: 0, size: 10}}">
<META HTTP-EQUIV="PREF.PRE"
	CONTENT="{font: {family: 'geneva, face: 0, size: 9}}">
</HEAD>

<BODY>
<H1><A NAME="Describe">Describe HelpURL</A></H1>
<P>
HelpURL shows how to
<OL>
<LI>add URLs to an about box
<LI>create a dynamic help book from HTML
</OL>

<P>
This works best with
<A HREF="http://www.netaxs.com/~weyer/newton/newtscape.html">Newt's Cape</A>
installed on NOS 2.0 (though it will also work on 1.x).



<H1><A NAME="DevelopAbout">Develop an About Box with URLs</A></H1>
<OL>
<LI>Use the protoAboutText object
<LI>Modify text, viewFont, etc. as appropriate.
<LI>Text slot can contain simple HREF expressions only (see example).
(For 1.x compatibility, use short lines with no wrapping.)
<LI>This is processed at compile-time
</OL>


<H1><A NAME="UseAbout">Use the About Box</A></H1>
<OL>
<LI>Users should install <A HREF="http://www.pobox.com/~flashsheridan">URLcop</A>
and/or <A HREF="http://www.netaxs.com/~weyer/newton/newtscape.html">Newt's Cape</A>
<LI>User taps on a URL in your About box
<LI>It dispatches according to protocol types registered with URLcop;
or, if just Newt's Cape is installed:
	<UL>
	<LI>http: -- sends document (from NIE or WebMail) to current "htmlApp" or "helperApp"
	<LI>mailto: -- generates Outbox message based on last mail transport
	<LI>news: -- dispatches to Newt's Paper
	</UL>
</OL>


<H1><A NAME="DevelopHelp">Develop a Help Book with URLs</A></H1>

<OL>
<LI>Create helpText (like this)
<LI>Set helpISBN slot (see afterScript for automatic substitution)
<LI>Copy DoInfoHelp method to your app's infoButton
<LI>install <A HREF="http://www.netaxs.com/~weyer/newton/newtscape.html">Newt's Cape</A>
<LI>select Help in your application (possibly making modifications iteratively)
<LI>optionally, Save the help book using Newt's Cape; upload and distribute with your application
</OL>


<H1><A NAME="UseHelp">Use the Help Book</A></H1>

<OL>
<LI>User installs either
	<UL>
	<LI>your saved help book
	<LI><A HREF="http://www.netaxs.com/~weyer/newton/newtscape.html">Newt's Cape</A>
	</UL>
<LI>Selects your i:Help button
<LI>Help book opens (or Newt's Cape processes HTML to create help book dynamically)
<LI>URLs to regular books and to web pages should work (links within help books might not work).
</OL>



<H1><A NAME="Understand">Understand the Code</A></H1>
<P>
Prerequisites: familiarity with both NewtonScript and HTML.

<P>To customize appearance, modify the Tag Prefs in Newt's Cape,
or you can add document-specific style preferences --
see the Newt's Cape documentation for further details.


<H1><A NAME="Distribute">Distribute HelpURL</A></H1>
<P>
HelpURL is freeware, and may be distributed freely as long as all of the
files are included and unmodified.  You are free to make modifications for
your own use. I would appreciate your references to the Newt's Cape URL:
http://www.netaxs.com/~weyer/newton/newtscape.html

<P>
&copy; Copyright 1996, S. Weyer. All Rights Reserved Worldwide.


<H1><A NAME="ContactAuthor">Contact Author</A></H1>

<PRE><A HREF="mailto:weyer@netaxs.com">Steve Weyer</A>
17 Timber Knoll Drive
Washington Crossing, PA 18977-1052
Internet: weyer@netaxs.com
America Online: SteveWeyer
Compuserve: 74603,2051
<A HREF="mailto:grs124@psu.edu">Greg Simon</A> -- Newt's Cape co-developer
<A HREF="http://www.netaxs.com/~weyer/newton/releases.html">http://www.netaxs.com/~weyer/newton/releases.html</A>

<A HREF="http://www.teleport.com/~gaia">Gaia Home page</A> -- info about intranet wireless handheld solutions
(re-using Newt's Cape technology).
</PRE>

</BODY>
</HTML>
